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NAME 

xkeyboard-config - XKB data description files 

DESCRIPTION 

xkeyboard-config provides the description files for the X Keyboard Extension (XKB). The configuration 
options below are usually applied with setxkbmap(l). 

MODELS 


X Version 11 


xkeyboard-config 2.26 


1 



XKEYBOARD-CONFIG(7) Miscellaneous Information Manual XKEYBOARD-CONFIG(7) 

LAYOUTS 


X Version 11 


xkeyboard-config 2.26 


2 



XKEYBOARD-CONFIG(7) 


Miscellaneous Information Manual 


XKEYBOARD-CONFIG(7) 


OPTIONS 

Switching to another layout 


Option 

Description 

grp: switch 

Right Alt (while pressed) 

grp :1s witch 

Left Alt (while pressed) 

grp:lwin_switch 

Left Win (while pressed) 

grp :rwin_s witch 

Left Win (while pressed) 

grp :win_s witch 

Any Win (while pressed) 

gr p: menu_s witch 

Menu (while pressed), Shift+Menu for Menu 

grp :caps_s witch 

Caps Lock (while pressed), Alt+Caps Lock for the original Caps Lock action 

grp:retrl_switch 

Right Ctrl (while pressed) 

grp: toggle 

Right Alt 

grp:lalt_toggle 

Left Alt 

grp:caps_toggle 

Caps Lock 

grp: shift_caps_toggle 

Shift+Caps Lock 

grp: shift_caps_switch 

Caps Lock to first layout; Shift+Caps Lock to last layout 

gr p: win_menu_s witch 

Left Win to first layout; Right Win/Menu to last layout 

grp:lctrl_rctrl_switch 

Left Ctrl to first layout; Right Ctrl to last layout 

gr p: alt_caps_toggle 

Alt+Caps Lock 

grp:shifts_toggle 

Both Shift together 

grp:alts_toggle 

Both Alt together 

grp:ctrls_toggle 

Both Ctrl together 

grp: ctrl_shift_toggle 

Ctrl+Shift 

gr p: lctrl_lshift_toggle 

Left Ctrl+Left Shift 

grp: retrl_rshift_toggle 

Right Ctrl+Right Shift 

gr p: ctrl_alt_toggle 

Alt+Ctrl 

gr p: alt_shift_toggle 

Alt+Shift 

grp:lalt_lshift_toggle 

Left Alt+Left Shift 

grp: alt_space_toggle 

Alt+Space 

gr p: menu_toggle 

Menu 

grp:lwin_toggle 

Left Win 

grp: win_space_toggle 

Win+Space 

grp:rwin_toggle 

Right Win 

grp:lshift_toggle 

Left Shift 

grp:rshift_toggle 

Right Shift 

grp:lctrl_toggle 

Left Ctrl 

grp:rctrl_toggle 

Right Ctrl 

grp:sclk_toggle 

Scroll Lock 

gr p: lctrl_l win_rctrl_menu 

Left Ctrl+Left Win to first layout; Right Ctrl+Menu to second layout 

grp:lctrl_lwin_toggle 

Left Ctrl+Left Win 


Key to choose the 3rd level 
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Option 

Description 

lv3:switeh 

Right Ctrl 

1 v3: menu_s witch 

Menu 

lv3:win_s witch 

Any Win 

lv3:lwin_switch 

Left Win 

lv3:rwin_s witch 

Right Win 

lv3:alt_s witch 

Any Alt 

lv3:lalt_switch 

Left Alt 

lv3:ralt_s witch 

Right Alt 

1 v3: ralt_s witch_multikey 

Right Alt; Shift+Right Alt as Compose 

lv3:ralt_alt 

Right Alt never chooses 3rd level 

lv3:enter_s witch 

Enter on keypad 

lv3:caps_s witch 

Caps Lock 

lv3:bksl_switch 

Backslash 

lv3:lsgt_switch 

<Less/Greater> 

1 v3: caps_s witch_latch 

Caps Lock; acts as onetime lock when pressed together with another 3rd-level chooser 

lv3: bksl_switch_latch 

Backslash; acts as onetime lock when pressed together with another 3rd level chooser 

lv3:lsgt_switch_latch 

<Less/Greater>; acts as onetime lock when pressed together with another 3rd level choose 


Ctrl position 


Option 

Description 

Ctrl: nocaps 

Caps Lock as Ctrl 

ctrl:lctrl_meta 

Left Ctrl as Meta 

ctrliswapcaps 

Swap Ctrl and Caps Lock 

ctrl:ac_ctrl 

At left of ’A’ 

ctrl:aa_ctrl 

At bottom left 

Ctrl :rctrl_r alt 

Right Ctrl as Right Alt 

ctrl:menu_rctrl 

Menu as Right Ctrl 

ctrl:swap_lalt_lctl 

Swap Left Alt with Left Ctrl 

ctrl:swap_lwin_lctl 

Swap Left Win with Left Ctrl 

ctrl:swap_rwin_rctl 

Swap Right Win with Right Ctrl 

ctrl:swap_lalt_lctl_lwin 

Left Alt as Ctrl, Left Ctrl as Win, Left Win as Left Alt 


Use keyboard LED to show alternative layout 


Option 

Description 

grp_led:num 

Num Lock 

grp_led:caps 

Caps Lock 

grp_led:scroll 

Scroll Lock 


Layout of numeric keypad 


X Version 11 


xkeyboard-config 2.26 


4 





XKEYBOARD-CONFIG(7) 


Miscellaneous Information Manual 


XKEYBOARD-CONFIG(7) 


Option 

Description 

keypad: legacy 
keypad: oss 
keypad:future 
keypad:legacy_wang 
keypad:oss_wang 
keypad:future_wang 
keypad:hex 
keypad: atm 

Legacy 

Unicode additions (arrows and math operators) 

Unicode additions (arrows and math operators; math operators on default level) 

Legacy Wang 724 

Wang 724 keypad with Unicode additions (arrows and math operators) 

Wang 724 keypad with Unicode additions (arrows and math operators; math operators on defat 
Hexadecimal 

ATM/phone- style 


Numeric keypad Delete behavior 


Option 

Description 

kpdl:dot 

Legacy key with dot 

kpdhcomma 

Legacy key with comma 

kpdhdotoss 

Four-level key with dot 

kpdl:dotoss_latin9 

Four-level key with dot, Latin-9 only 

kpdhcommaoss 

Four-level key with comma 

kpdhmomayyezoss 

Four-level key with momayyez 

kpdhkposs 

Four-level key with abstract separators 

kpdl:semi 

Semicolon on third level 


Caps Lock behavior 


Option 

Description 

caps:internal 

Caps Lock uses internal capitalization; Shift "pauses" Caps Lock 

caps:internal_nocancel 

Caps Lock uses internal capitalization; Shift does not affect Caps Lock 

caps:shift 

Caps Lock acts as Shift with locking; Shift "pauses" Caps Lock 

caps:shift_nocancel 

Caps Lock acts as Shift with locking; Shift does not affect Caps Lock 

caps:capsloek 

Caps Lock toggles normal capitalization of alphabetic characters 

caps:shiftloek 

Caps Lock toggles ShiftLock (affects all keys) 

caps:swapescape 

Swap ESC and Caps Lock 

caps:escape 

Make Caps Lock an additional Esc 

caps:backspace 

Make Caps Lock an additional Backspace 

caps:super 

Make Caps Lock an additional Super 

caps:hyper 

Make Caps Lock an additional Hyper 

capsmienu 

Make Caps Lock an additional Menu key 

capsmumlock 

Make Caps Lock an additional Num Lock 

caps:ctrl_modifler 

Caps Lock is also a Ctrl 

capsmone 

Caps Lock is disabled 


Alt/Win key behavior 
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Option 

Description 

altwin:menu 

Add the standard behavior to Menu key 

altwin:meta_alt 

Alt and Meta are on Alt 

altwin:alt_win 

Alt is mapped to Win and the usual Alt 

altwin:ctrl_win 

Ctrl is mapped to Win and the usual Ctrl keys 

alt win: ctrl_alt_win 

Ctrl is mapped to Alt; Alt is mapped to Win 

alt win: meta_win 

Meta is mapped to Win 

altwin:left_meta_win 

Meta is mapped to Left Win 

alt win: hy per_win 

Hyper is mapped to Win 

altwin:alt_super_win 

Alt is mapped to Right Win, Super to Menu 

altwin:swap_lalt_lwin 

Left Alt is swapped with Left Win 

alt win: swapaltvvin 

Alt is swapped with Win 

altwin:prtsc_rwin 

Win is mapped to PrtSc and the usual Win 


Position of Compose key 


Option 

Description 

composerralt 

Right Alt 

composerlwin 

Left Win 

composerlwin-altgr 

3rd level of Left Win 

compose:rwin 

Right Win 

compose:rwin-altgr 

3rd level of Right Win 

composemienu 

Menu 

composermenu-altgr 

3rd level of Menu 

composerlctrl 

Left Ctrl 

composerlctrl-altgr 

3rd level of Left Ctrl 

compose:rctrl 

Right Ctrl 

compose:rctrl-altgr 

3rd level of Right Ctrl 

composercaps 

Caps Lock 

composercaps-altgr 

3rd level of Caps Lock 

compose: 102 

<Less/Greater> 

compose: 102-altgr 

3rd level of <Less/Greater> 

composerpaus 

Pause 

composerprsc 

PrtSc 

composersclk 

Scroll Lock 


Miscellaneous compatibility options 
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Option 

numpad:pc 

numpad:mac 

numpad:microsoft 

numpad:shift3 

srvrkeys:none 

appleralupckeys 

shift:breaks_caps 

miscrtypo 

shift:both_capslock 

shift:both_capslock_cancel 

shift:both_shiftlock 

keypad: pointerkeys 

gr ab: break_actions 

grab: debug 


Description 

Default numeric keypad keys 

Numeric keypad always enters digits (as in macOS) 

Num Lock on: digits; Shift for arrow keys. Num Lock off: arrow keys (as in Windows) 
Shift does not cancel Num Lock, chooses 3rd level instead 
Special keys (Ctrl+Alt+<key>) handled in a server 

Apple Aluminium: emulate PC keys (PrtSc, Scroll Lock, Pause, Num Lock) 

Shift cancels Caps Lock 

Enable extra typographic characters 

Both Shift together enable Caps Lock 

Both Shift together enable Caps Lock; one Shift key disables it 
Both Shift together enable Shift Lock 
Shift + Num Lock enables PointerKeys 

Allow breaking grabs with keyboard actions (warning: security risk) 

Allow grab and window tree logging 


Adding currency signs to certain keys 


Option 

Description 

eurosign:e 

Euro on E 

eurosign:2 

Euro on 2 

eurosign:4 

Euro on 4 

eurosign:5 

Euro on 5 

rupeesign:4 

Rupee on 4 


Key to choose 5th level 


Option 

Description 

lv5:lsgt_switch_lock 

1 v5: ralt_s witch_lock 

1 v5:1 win_s witch_lock 
lv5: rwin_switch_lock 

<Less/Greater> chooses 5th level; acts as onetime lock when pressed together with another 5tl 
Right Alt chooses 5th level; acts as onetime lock when pressed together with another 5th level 
Left Win chooses 5th level; acts as onetime lock when pressed together with another 5th level 
Right Win chooses 5th level; acts as onetime lock when pressed together with another 5th leve 


Using space key to input non-breaking space 
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Option 

nbsp:none 

nbsp:level2 

nbsp:level3 

nbsp:level3s 

nbsp:level3n 

nbsp:level4 

nbsp:level4n 

nbsp:level4nl 

nbsp:zwnj2 

nbsp:zwnj2zwj3 

nbsp:zwnj2zwj3nb4 

nbsp:zwnj2nb3 

nbsp:zwnj2nb3s 

nbsp:zwnj2nb3zwj4 

nbsp:zwnj2nb3nnb4 

nbsp:zwnj3zwj4 


Description 

Usual space at any level 
Non-breaking space at the 2nd level 
Non-breaking space at the 3rd level 

Non-breaking space at the 3rd level, nothing at the 4th level 
Non-breaking space at the 3rd level, thin non-breaking space at the 4th level 
Non-breaking space at the 4th level 

Non-breaking space at the 4th level, thin non-breaking space at the 6th level 
Non-breaking space at the 4th level, thin non-breaking space at the 6th level (via Ctrl+Shift) 
Zero-width non-joiner at the 2nd level 

Zero-width non-joiner at the 2nd level, zero-width joiner at the 3rd level 
Zero-width non-joiner at the 2nd level, zero-width joiner at the 3rd level, non-breaking space al 
Zero-width non-joiner at the 2nd level, non-breaking space at the 3rd level 
Zero-width non-joiner at the 2nd level, non-breaking space at the 3rd level, nothing at the 4th 1< 
Zero-width non-joiner at the 2nd level, non-breaking space at the 3rd level, zero-width joiner al 
Zero-width non-joiner at the 2nd level, non-breaking space at the 3rd level, thin non-breaking s 
Zero-width non-joiner at the 3rd level, zero-width joiner at the 4th level 


Japanese keyboard options 


Option 

Description 

japan:kana_lock 

Kana Lock key is locking 

japan:nicola_f_bs 

NICOLA-F style Backspace 

japan:hztg_escape 

Make Zenkaku Hankaku an additional Esc 


Korean Hangul/Hanja keys 


Option 

Description 

korean: r alt_rctrl 
korean: rctrl_r alt 

Right Alt as Hangul, right Ctrl as Hanja 
Right Ctrl as Hangul, right Alt as Hanja 


Adding Esperanto supersigned letters 


Option 

esperanto: qwerty 
esperantordvorak 
esperantorcolemak 


Description 

To the corresponding key in a QWERTY layout 
To the corresponding key in a Dvorak layout 
To the corresponding key in a Colemak layout 


Maintain key compatibility with old Solaris keycodes 
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Option 

Description 

solaris:sun_compat 

Sun Key compatibility 


Key sequence to kill the X server 


Option 

Description 

terminate:ctrl_alt_bksp 

Ctrl+Alt+B ackspace 


FILES 

/usr/share/Xl 1/xkb/compat 
/usr/share/Xl 1/xkb/compiled 
/usr/share/Xl 1/xkb/geometry 
/usr/share/Xl 1/xkb/keycodes 
/usr/share/Xl 1/xkb/keymap 
/usr/share/Xl 1/xkb/rules 
/usr/share/Xl 1/xkb/semantics 
/usr/share/Xl 1/xkb/symbols 
/usr/share/Xl 1/xkb/types 

SEE ALSO 

setxkbmap(l) 


X Version 11 


xkeyboard-config 2.26 


9 





